home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / utils / misc / machv / update50.doc < prev    next >
Text File  |  1993-12-31  |  27KB  |  788 lines
  1.                           NOTE! NOTE! NOTE!
  2.  
  3. Users of MachIV should note these changes:
  4.  
  5. 1. Unless specified on the command line or in the Tool Types, MachV will 
  6.    try to read an ENVARC:MachV/MachV.prefs preference file. If that is not
  7.    found, it will try ENVARC:MachIV/MachIV.prefs.
  8.  
  9. 2. Note the functions that have been renamed below. You will have to
  10.    rename these in your macros.
  11.  
  12. 3. Also note the functions that have been removed and delete these from
  13.    your macros.
  14.  
  15. 4  You will need to change all win_activate"" functions to win_activate"M".
  16.  
  17. 5. If you are upgrading from MachIV, all changes are listed here. These
  18.    changes have also been made to the MachV.guide file.
  19.  
  20. 6. AllTitles and AllTasks have been removed from the disk. They have been
  21.    replaced by "Select Title" in SetMachV. See SetMachV #14 below.
  22. =========================================================================
  23.                     MachV and SetMachV - Version 5.0
  24.  
  25. MachV now has (and requires) the library mach.library. With this library
  26. and the included header files, programmers can now access many of MachV's
  27. features and settings. SetMachV itself uses just this library to
  28. completely control MachV. See programmers docs for more details.
  29.  
  30. =========================================================================
  31. Functions Removed
  32. -----------------
  33.  
  34. Several macro functions have been removed. If you have any of these in
  35. your configuration, you should delete them.
  36.  
  37. All Graphics functions - MachV is not pretending to be a graphics
  38.                          utility. With the increased number of graphic 
  39.                          modes available, it is better to use a separate
  40.                          utility program.
  41.  
  42. Msc_Patch_Newlook      - This is replaced by the program ScreenDebut
  43.                          included on the disk.
  44.  
  45. Set_Key                - This was used mainly to set the middle mouse
  46.                          button to the shift key. Do this in the
  47.                          'Miscellaneous Features' window.
  48.  
  49. Set_SetMachV_Path      - The path and name for SetMachV is now a
  50.                          command line or icon ToolType option.
  51.  
  52. Set_Month_Names and    - These are available through the appropriate     
  53. Set_Day_Names            language catalogs or machv.txt file.
  54. =========================================================================
  55. Functions Renamed
  56. -----------------
  57.  
  58. The following functions have been renamed:
  59.  
  60.         Before                  Now
  61.         ------                  ---
  62.         Clk_Meter_Reset         Clk_Reset_Meter
  63.         Scr_Kill                Scr_Kill_Screen
  64.         Scr_Select              Scr_Select_Screen
  65.         Win_Change              Win_Change_Window
  66.         Win_Kill                Win_Kill_Window
  67.         Win_Layer               Win_Layer_Windows
  68.         Win_Move                Win_Move_Window
  69.         Win_Select              Win_Select_Window
  70.         Win_Size                Win_Size_Window
  71.  
  72. Since the prefixes are not needed, this makes some functions clearer and
  73. unambiguous. e.g. 'Win_Kill' and 'Scr_Kill' are ambiguous as just 'Kill'.
  74. Kill_Window and Kill_Screen is clearer.
  75.  
  76. Note that not all ambiguities have been removed. The following must 
  77. include their prefixes:
  78.  
  79.         Clk_To_Front
  80.         Win_To_Front
  81.         Scr_To_Front
  82.         Win_Back_To_Front
  83.         Scr_Back_To_Front
  84.         Win_Front_To_Back
  85.         Scr_Front_To_Back
  86.         
  87. See below for On_Off functions that have been renamed.
  88.  
  89. =========================================================================
  90. Function Changes
  91. ----------------
  92.  
  93. All window functions operate on the window as selected in this manner:
  94.  
  95.     Top window -
  96.  
  97.         win_function                    For compatibility with 4.2
  98.         win_function"T"
  99.         win_function"T,arg2,arg3,..."
  100.  
  101.     Active window -
  102.  
  103.         win_function""                  For compatibility with 4.2
  104.         win_function"A"
  105.         win_function"A,arg2,arg3,..."
  106.         win_function",arg2,arg3,..."    For compatibility with 4.2
  107.  
  108.     Under mouse window -
  109.  
  110.         win_function"M"
  111.         win_function"M,arg2,arg3,..."
  112.  
  113.     Titled window -
  114.  
  115.         win_function"title"
  116.         win_function"title,arg2,arg3,..."
  117.  
  118. While window functions select the window the same way as in previous
  119. versions (except win_activate), you should use 'T', 'A' and 'M' for top,
  120. active and (under) mouse. There is only the remote possiblity of a
  121. conflict if you must specify a window whose title is one of these single
  122. characters. In these cases you could use:
  123.  
  124.         win_function"(A)"
  125.         win_function"(M)"
  126.         win_function"(T)"
  127.  
  128. Note: You will need to change any win_activate"" functions to 
  129.       win_activate"M"
  130.  
  131.       If there is no window under the mouse, the top window will become
  132.       active.
  133.  
  134. On Off Functions
  135. ----------------
  136.  
  137. All on/off functions have been changed to be a little less tedious to type
  138. and to be clearer. The argument can now be 'On' or 'Off' as well as '1' or
  139. '0'. 'Tog' will toggle the feature as will no argument.
  140.  
  141.         Before                      Now
  142.         ------                      ---
  143.         Clk_On_Off"1"               Clk_Clock"On"
  144.         Mac_On_Off"0"               Mac_Macros"Off"
  145.         Mou_Sun_On_Off""            Mac_SunMouse"Tog"
  146.         Mou_To_Menu_On_Off"1"       Mou_To_Menu"On"
  147.         Mou_FreezeVert_On_Off"0"    Mou_FreezeVert"Off" 
  148.         Mou_FreezeHorz_On_Off       Mou_FreezeHorz"Tog" 
  149.         Msc_HoldQuals_On_Off"1"     Msc_HoldQuals"On"   
  150.         Msc_Speak_On_Off"0"         Msc_Speak"Off"  
  151.         Msc_Keys_On_Off""           Msc_FreezeKeys"Tog"
  152.         Msc_Debug_On_Off"1"         Msc_Debug"On"   
  153.  
  154. Because no argument is the same as 'Tog', and because prefixes are not
  155. always required, and because keywords are case insensitive, 
  156. 'Clk_Clock"Tog"' is equivalent to 'clock'.
  157.  
  158. Macro Names
  159. -----------
  160.  
  161. The following functions previously accepted only a macro name. They now
  162. can accept wildcards.
  163.  
  164.     Mac_Execute_Named"name"
  165.     Mac_Delete"name"
  166.     Msc_Set_Flags"xx,name"
  167.  
  168. Example:
  169.  
  170.         Mac_Execute_Named"test#?" beep"5"
  171.  
  172. This will queue up all macros that have a name beginning with 'test'. When
  173. the queued macros have executed, this macro will continue at the 'beep"5"'.
  174. This has the potential to be quite dangerous - USE WITH CAUTION! 
  175.  
  176. Msc_Set_Flags has been changed slightly. Previously it actually toggled 
  177. the desired flag. Now it sets it unless a third argument of '0' is 
  178. supplied. Example:
  179.  
  180.         Msc_Set_Flags"40,#?,0"
  181.  
  182.     This clears the 'Disabled' flag in all macros.
  183.  
  184.         Msc_Set_Flags"80,#?"
  185.  
  186.     This sets the 'Write Protected' flag in all macros.
  187.  
  188. Msc_Beep
  189. --------
  190.  
  191. Beep and Key Click each have a volume setting in 'Miscellaneous Features'.
  192. The Beep volume can be over-ridden by a second argument to Msc_Beep.
  193.  
  194.         Msc_Beep"1,64"          one beep, full volume.
  195.         Msc_Beep"2,32"          two beeps, half volume.
  196.         Msc_Beep",64"           one beep, full volume.
  197.  
  198. Mac_Macros and Msc_Suspend
  199. --------------------------
  200.  
  201. When either of these functions are executed and disable macros or suspend
  202. MachV, the SAME hotkey must be used to re-enable.
  203.  
  204. =========================================================================
  205. New Functions
  206. -------------
  207.  
  208.         Msc_Meter
  209.         Msc_PutMsg_ARexx
  210.         Msc_Send_Upkeys
  211.         Msc_Status
  212.         Msc_Trace
  213.         Set_Variable
  214.         Win_Wait_Window
  215.         Win_Window_Open
  216.  
  217. Msc_Meter
  218. ---------
  219.  
  220. Turn the meter on or off. The meter can now be used to measure time if the
  221. rate is set to 0. You may have the meter on in different configurations 
  222. and keep track of how much time you spend in each configuration or program.
  223. Time is not counted when the screen is blanked, but online costs are.
  224.  
  225.         Msc_Meter"On"
  226.         Msc_Meter"Off"
  227.         Msc_Meter"Tog"
  228.  
  229. Msc_PutMsg_ARexx
  230. ----------------
  231.  
  232. Send a command directly to an ARexx port. With this function, you can avoid
  233. using 'run rx command'. This function is synchronous! It will not return
  234. until replied to by the receiving process.
  235.  
  236.         Msc_PutMsg_ARexx"PORTNAME,command"
  237.  
  238. Examples:
  239.  
  240.         Msc_PutMsg_ARexx"TURBOTEXT0,openfile ${ttxfile}"
  241.  
  242.         Msc_PutMsg_ARexx"EMACS1,(fill-paragraph nil)"
  243.  
  244.